home *** CD-ROM | disk | FTP | other *** search
/ NetNews Offline 2 / NetNews Offline Volume 2.iso / news / comp / sys / amiga / networking / 503 < prev    next >
Encoding:
Internet Message Format  |  1996-08-05  |  25.3 KB

  1. Path: hearst.acc.Virginia.EDU!adastra!mbs
  2. Newsgroups: comp.sys.amiga.networking
  3. From: mbs@adastra.cvl.va.us (Michael B. Smith)
  4. Subject: Re: Best Mail Program for use with SLIP, SMTP, POP, AmiTCP?
  5. Distribution: world
  6. References: <4bu7f9$nt6@news-s01.ny.us.ibm.net> <19951228.7655D90.13B1A@ragtime.vnet.net> <19960113.41B940.10EA1@an196.du.pipex.com> <4ddmbn$3tbc@news-s01.ny.us.ibm.net>
  7. X-NewsReader: GRn 3.0 January 12, 1996
  8. MIME-Version: 1.0
  9. Content-Type: text/plain; charset=iso-8859-1
  10. Content-Transfer-Encoding: 8bit
  11. Message-ID: <mbs.47b7@adastra.cvl.va.us>
  12. Date: Mon, 15 Jan 96 18:16:50 EDT
  13. Organization: Only if you insist...
  14.  
  15. In article <4ddmbn$3tbc@news-s01.ny.us.ibm.net> heitkamp@ibm.net (Frederick V. Heitkamp) writes:
  16. > : at once than by using environment variables? With a single, integrated program
  17. > : (like THOR) it makes sense to encapsulate all the settings in one file, and
  18. > : use a prefs editor, but if you have a big bunch of separate applications for
  19. > : different tasks (UUCP, NNTP, POP, SMTP etc.), the cleanest way is to define
  20. > : global environment variables which are simple and accessible to all programs.
  21. > : People are scared off by setting them all up, though.
  22. >
  23. > Folks writing internet apps for the Amiga should use UUCP as their standard for
  24. > specifying setups then.  How about a complete UUCP FAQ and guide directed
  25. > toward the AmiTCP/internet crowd with plenty of  background and tutorial
  26. > information?
  27.  
  28. Having written much of the first generation of Internet software, I did just
  29. that. The GRn guide was pretty complete, as is the INetUtils documentation.
  30. Granted, they weren't the easiest things in the world to read.
  31.  
  32. The document below, which I've posted several times recently, helps a great
  33. deal. It applies to I-Net 225, INetUtils 1.4 (the last freeware version) and
  34. GRn 2.1 (the last freeware version).
  35. --
  36.   //   Michael B. Smith
  37. \X/    mbs@adastra.cvl.va.us
  38.  
  39. @database ConfigVars.guide
  40. @Author "Michael B. Smith"
  41. @$VER: ConfigVars.guide 1.0 (29.12.95)
  42. @Width 80
  43. @SmartWrap
  44. #@Font topaz.font 11
  45.  
  46. @Node Main "ConfigVars"
  47. @{b}ConfigVars@{ub}                                @{b}ConfigVars@{ub}
  48.  
  49.  
  50. @{b}INet:s/Config@{ub} is intended as a general purpose registry for program
  51. configuration, where those programs are TCP-stack related. As such, we document
  52. all of the variables which I-Net 225 uses.
  53.  
  54.  
  55. The user does not have to use the @{b}INet:s/Config@{ub} file for setting
  56. configuration information. All values will first be read from the program's
  57. environment, before any value in that file is checked. In order of hierarchy,
  58. the following applies:
  59.  
  60.  
  61.     a program's local environment
  62.  
  63.     the global environment
  64.  
  65.     the contents of @{b}INet:s/Config@{ub}
  66.  
  67.  
  68. If you are using any of the @{b}INetUtils@{ub}, @{b}GRn@{ub}, or @{b}GMail@{ub} programs,
  69. this information also applies to you. If your version was compiled
  70. for AmiTCP or UUCP, instead of for I-Net 225, the filename used is S:UUConfig.
  71.  
  72.  
  73. If your TCP/IP stack has been installed correctly, then you are not @{u}required@{uu} to
  74. set any values in this file. The only required settings are:
  75.  
  76.  
  77.     @{"User" link user}
  78.  
  79.  
  80.     @{"Hostname" link hostname}
  81.  
  82.  
  83. and these are set by both available TCP/IP stacks in the global environment.
  84.  
  85.  
  86. However, if you using an @{u}old@{uu} version of INetUtils (the freeware
  87. version 1.4 or before) you should read @{"this section" link oldrequirements} of
  88. this manual.
  89.  
  90.  
  91. Configuration falls into three categories: general, mail, and news. Select the
  92. button for the area in which you are interested.
  93.  
  94.  
  95.     @{"General" link configgeneral}
  96.  
  97.  
  98.     @{"Mail" link configmail}
  99.  
  100.  
  101.     @{"News" link confignews}
  102.  
  103.  
  104. There are also some configuration variables commonly used by other programs.
  105. Click @{"here" link otherstuff} for descriptions of those.
  106.  
  107.  
  108. @EndNode
  109.  
  110. @Node oldrequirements "Requirements for INetUtils 1.4 and prior"
  111.  
  112.  
  113. This is @{u}only@{uu} for @{b}old@{ub} versions of INetUtils and GRn.
  114.  
  115.  
  116. Freeware versions of INetUtils required more configuration, due to having
  117. fewer defaults defined. In general, you @{u}had@{uu} to configure these
  118. items:
  119.  
  120.  
  121.     @{u}General@{uu}
  122.  
  123.  
  124.     User
  125.  
  126.     Nodename
  127.  
  128.     Hostname
  129.  
  130.     LibDir
  131.  
  132.  
  133.     @{u}Mail@{uu}
  134.  
  135.  
  136.     SMTPMailDir
  137.  
  138.     SMTPSmarterHost
  139.  
  140.     SMTPSpoolDir
  141.  
  142.  
  143.     @{u}News@{uu}
  144.  
  145.  
  146.     NewsDir
  147.  
  148.  
  149. GRn versions prior to 3.0 also required UUSpool, @{u}only@{uu} to define
  150. where to place its logfile.
  151.  
  152.  
  153. However, this is not as bad as it may appear. Nodename should be, for all
  154. intents and purposes, the same as Hostname. The other values need only to
  155. be set once, and then can be left alone. User and Hostname should be set
  156. by your TCP/IP stack.
  157.  
  158.  
  159. Contrary to some beliefs, INetUtils does not require UUCP to be installed
  160. before. For explanations of each of these values, see the descriptive text
  161. in other places in this document.
  162.  
  163.  
  164. Thus, a simple script like that shown below, running after your network
  165. connection is active, and it will take care of any problems.
  166.  
  167.  
  168. Note that there are two scripts,
  169. the first is for AS225, the other is for AmiTCP. They differ only in
  170. selected directory locations. If you have I-Net 225, or the commercial
  171. version of INetUtils, you do not need to execute these scripts. Also note
  172. that you can "assign inet: amitcp:" and run the AS225 version just as
  173. easily as the AmiTCP version.
  174.  
  175.  
  176. It is recommended that you select a proper value for SMTPSmarterhost; however,
  177. the value below will get you running. Your network provider can tell you what
  178. the correct value is.
  179.  
  180.  
  181. AS225 script:
  182.  
  183.  
  184.     setenv libdir inet:s
  185.  
  186.     setenv uuspool inet:
  187.  
  188.     setenv nodename $hostname
  189.  
  190.     if not exists inet:mail
  191.  
  192.         makedir inet:mail
  193.  
  194.     endif
  195.  
  196.     setenv smtpmaildir inet:mail
  197.  
  198.     if not exists inet:mailspool
  199.  
  200.         makedir inet:mailspool
  201.  
  202.     endif
  203.  
  204.     setenv smtpmailspool inet:mailspool
  205.  
  206.     if "$smtpsmarterhost" eq ""
  207.  
  208.         setenv smtpsmarterhost dummy
  209.  
  210.     endif
  211.  
  212.     if "$smtpsmarterhost" eq "*$smtpsmarterhost"
  213.  
  214.         setenv smtpsmarterhost dummy
  215.  
  216.     endif
  217.  
  218.     if not exists inet:news
  219.  
  220.         makedir inet:news
  221.  
  222.     endif
  223.  
  224.     setenv newsdir inet:news
  225.  
  226.  
  227. AmiTCP script:
  228.  
  229.  
  230.     setenv libdir amitcp:db
  231.  
  232.     setenv uuspool amitcp:
  233.  
  234.     setenv nodename $hostname
  235.  
  236.     if not exists amitcp:mail
  237.  
  238.         makedir amitcp:mail
  239.  
  240.     endif
  241.  
  242.     setenv smtpmaildir amitcp:mail
  243.  
  244.     if not exists amitcp:mailspool
  245.  
  246.         makedir amitcp:mailspool
  247.  
  248.     endif
  249.  
  250.     setenv smtpmailspool amitcp:mailspool
  251.  
  252.     if "$smtpsmarterhost" eq ""
  253.  
  254.         setenv smtpsmarterhost dummy
  255.  
  256.     endif
  257.  
  258.     if "$smtpsmarterhost" eq "*$smtpsmarterhost"
  259.  
  260.         setenv smtpsmarterhost dummy
  261.  
  262.     endif
  263.  
  264.     if not exists amitcp:news
  265.  
  266.         makedir amitcp:news
  267.  
  268.     endif
  269.  
  270.     setenv newsdir amitcp:news
  271.  
  272.  
  273. @Endnode
  274.  
  275. @Node configgeneral "General Configuration"
  276.  
  277.  
  278. General configuration elements affect both news and mail, or even
  279. other aspects of the TCP stack.
  280.  
  281.  
  282. The relevant items are:
  283.  
  284.  
  285.     @{"User" link user}
  286.  
  287.  
  288.     @{"Realname" link realname}
  289.  
  290.  
  291.     @{"Nodename" link nodename}
  292.  
  293.  
  294.     @{"Domainname" link domainname}
  295.  
  296.  
  297.     @{"Hostname" link hostname}
  298.  
  299.  
  300.     @{"Logfile" link logfile}
  301.  
  302.  
  303.     @{"LibDir" link libdir}
  304.  
  305.  
  306.     @{"TimeZone" link timezone}
  307.  
  308.  
  309. @EndNode
  310.  
  311. @Node configmail "Mail Configuration"
  312.  
  313.  
  314. Mail configuration variables affect only mail. If you are not using
  315. features dealing with mail, they need not be set.
  316.  
  317.  
  318. The relevant items are:
  319.  
  320.  
  321.     @{"SMTPPost" link smtppost}
  322.  
  323.  
  324.     @{"SMTPSpoolDir" link smtpspooldir}
  325.  
  326.  
  327.     @{"SMTPMailDir" link smtpmaildir}
  328.  
  329.  
  330.     @{"SMTPRMail" link smtprmail}
  331.  
  332.  
  333.     @{"SMTPDelay" link smtpdelay}
  334.  
  335.  
  336.     @{"SMTPRoute" link smtproute}
  337.  
  338.  
  339.     @{"SMTPAlwaysQueue" link smtpalwaysqueue}
  340.  
  341.  
  342.     @{"HostAliases" link hostaliases}
  343.  
  344.  
  345.     @{"CheckUser" link checkuser}
  346.  
  347.  
  348.     @{"SmartFrom" link smartfrom}
  349.  
  350.  
  351.     @{"UUCPSendMail" link uucpsendmail}
  352.  
  353.  
  354.     @{"MailReadyCMD" link mailreadycmd}
  355.  
  356.  
  357. @EndNode
  358.  
  359. @Node confignews "News Configuration"
  360.  
  361.  
  362. News configuration variables affect only news. If you are not using features
  363. dealing with news, they need not be set.
  364.  
  365.  
  366. The relevant items are:
  367.  
  368.  
  369.     @{"NewsDir" link newsdir}
  370.  
  371.  
  372.     @{"NNTPRNews" link nntprnews}
  373.  
  374.  
  375.     @{"NNTPServer" link nntpserver}
  376.  
  377.  
  378.     @{"NNTPUserid" link nntpuserid}
  379.  
  380.  
  381.     @{"NNTPPassword" link nntppassword}
  382.  
  383.  
  384. @EndNode
  385.  
  386. @Node user "Configuration - User"
  387.  
  388.  
  389. Local Environment:    set user mbs
  390.  
  391. Global Environment:    setenv user mbs
  392.  
  393. Configuration File:    user mbs
  394.  
  395. Default:        none
  396.  
  397.  
  398. "Username" is a deprecated synonym for "user".
  399.  
  400.  
  401. @{b}User@{ub} defines the login identity of the person using the computer. It is
  402. normally set by the login program of the TCP/IP stack. @{b}User@{ub} must
  403. exist in the password file.
  404.  
  405.  
  406. @{b}User@{ub} is used by various mail and news programs to construct the From: and/or
  407. Sender: headers used for identification purposes.
  408.  
  409.  
  410. I-Net 225 requires that the uid and gid specified in @{b}INet:s/inet.config@{ub} for
  411. @{b}User@{ub} also match the entries in the password file.
  412.  
  413.  
  414. @EndNode
  415.  
  416. @Node realname "Configuration - Realname"
  417.  
  418.  
  419. Local Environment:    set realname Mondo B. Sasquatch
  420.  
  421. Global Environment:    setenv realname Mondo B. Sasquatch
  422.  
  423. Configuration File:    Realname Mondo B. Sasquatch
  424.  
  425. Default:        none
  426.  
  427.  
  428. The @{b}Realname@{ub} is the proper name by which a computer user is to be known.
  429. It is used by various mail and news programs to construct the From: and/or
  430. Sender: headers used for identification purposes.
  431.  
  432.  
  433. @EndNode
  434.  
  435. @Node nodename "Configuration - Nodename"
  436.  
  437.  
  438. Local Environment:    set nodename mycomputer
  439.  
  440. Global Environment:    setenv nodename mycomputer
  441.  
  442. Configuration File:    Nodename mycomputer
  443.  
  444. Default:        none
  445.  
  446.  
  447. Use of this is not recommended. Use @{"Hostname" link hostname} instead.
  448.  
  449.  
  450. The @{b}Nodename@{ub} is normally the first piece of the @{b}Hostname@{ub} of a computer.
  451. For example, with a @{b}Hostname@{ub} of "mycomputer.somedomain.com" the @{b}Nodename@{ub}
  452. would be "mycomputer". The @{b}Domainname@{ub} would be ".somedomain.com".
  453.  
  454.  
  455. @EndNode
  456.  
  457. @Node domainname "Configuration - Domainname"
  458.  
  459.  
  460. Local Environment:    set domainname .somedomain.com
  461.  
  462. Global Environment:    setenv domainname .somedomain.com
  463.  
  464. Configuration File:    Domainname .somedomain.com
  465.  
  466. Default:        none
  467.  
  468.  
  469. Use of this is not recommended. Use @{"Hostname" link hostname} instead.
  470.  
  471.  
  472. The @{b}Domainname@{ub} is normally the rest of the @{b}Hostname@{ub} of a computer after
  473. the @{b}Nodename@{ub}. For
  474. example, with a @{b}Hostname@{ub} of "mycomputer.somedomain.com" the @{b}Nodename@{ub} would
  475. be "mycomputer". The @{b}Domainname@{ub} would be ".somedomain.com".
  476.  
  477.  
  478. @EndNode
  479.  
  480. @Node hostname "Configuration - Hostname"
  481.  
  482.  
  483. Local Environment:    set hostname mycomputer.com
  484.  
  485. Global Environment:    setenv hostname mycomputer.com
  486.  
  487. Configuration File:    Hostname mycomputer.com
  488.  
  489. Default:        none
  490.  
  491.  
  492. Be very careful if you set this. Normally, this should be set by the
  493. TCP/IP stack, and you should not modify it.
  494.  
  495.  
  496. @{b}Hostname@{ub} is the fully qualified domain name of the current computer.
  497.  
  498.  
  499. Various programs must be able to obtain the @{b}Hostname@{ub} of the computer.
  500. They will try to do this first from the @{b}Hostname@{ub} string, next
  501. from a combination of @{b}NodeName@{ub} and @{b}DomainName@{ub}, and finally
  502. from the TCP/IP stack API call @{b}gethostname()@{ub}. If all of these
  503. fail, the programs will display an error message and terminate.
  504.  
  505.  
  506. @EndNode
  507.  
  508. @Node logfile "Configuration - Logfile"
  509.  
  510.  
  511. Local Environment:    set logfile Work:INet225-logfile
  512.  
  513. Global Environment:    setenv logfile Work:INet225-logfile
  514.  
  515. Configuration File:    logfile Work:INet225-logfile
  516.  
  517. Default I-Net 225:    INet:Logfile
  518.  
  519. Default AmiTCP:     AmiTCP:Logfile
  520.  
  521. Default UUCP:        UUSpool:Logfile
  522.  
  523.  
  524. Various pieces of information concerning status and errors are
  525. stored in the @{b}Logfile@{ub}. You should examine/flush/empty this file
  526. on a regular basis.
  527.  
  528.  
  529. If you do not want logging information stored, you may set the
  530. @{b}Logfile@{ub} to NIL:.
  531.  
  532.  
  533. @EndNode
  534.  
  535.  
  536. @Node libdir "Configuration - LibDir"
  537.  
  538.  
  539. Local Environment:    set libdir INet:s
  540.  
  541. Global Environment:    setenv libdir INet:s
  542.  
  543. Configuration File:    LibDir INet:s
  544.  
  545. Default I-Net 225:    INet:s
  546.  
  547. Default AmiTCP:     UULib:
  548.  
  549. Default UUCP:        UULib:
  550.  
  551.  
  552. The @{b}LibDir@{ub} is the directory where certain files are stored. The files are:
  553.  
  554.  
  555.     <user>.header
  556.  
  557.     <user>.signature
  558.  
  559.     news/active
  560.  
  561.  
  562. The various mail and news programs will search for these files in that
  563. directory.
  564.  
  565.  
  566. @EndNode
  567.  
  568. @Node organization "Configuration - Organization"
  569.  
  570.  
  571. Local Environment:    set organization Not here, not ever.
  572.  
  573. Global Environment:    setenv organization Not here, not ever.
  574.  
  575. Configuration File:    Organization Not here, not ever.
  576.  
  577. Default:        none
  578.  
  579.  
  580. @{b}Organization@{ub} is an optional header for mail and news messages. If
  581. defined, the various mail and news programs will include this string
  582. as that header.
  583.  
  584.  
  585. It typically denotes a company affiliation.
  586.  
  587.  
  588. @EndNode
  589.  
  590. @Node newsdir "Configuration - NewsDir"
  591.  
  592.  
  593. Local Environment:    set newsdir INet:News
  594.  
  595. Global Environment:    setenv newsdir INet:News
  596.  
  597. Configuration File:    NewsDir INet:News
  598.  
  599. Default I-Net 225:    INet:News
  600.  
  601. Default AmiTCP:     AmiTCP:News
  602.  
  603. Default UUCP:        UUNews:
  604.  
  605.  
  606. @{b}NewsDir@{ub} is where transferred news articles are stored.
  607.  
  608.  
  609. @EndNode
  610.  
  611. @Node nntprnews "Configuration - NNTPRnews"
  612.  
  613.  
  614. Local Environment:    set nntprnews uucp:c/news -p
  615.  
  616. Global Environment:    setenv nntprnews uucp:c/rnews -p
  617.  
  618. Configuration File:    NNTPRNews uucp:c/rnews -p
  619.  
  620. Default:        none
  621.  
  622.  
  623. @{b}NNTPxfer@{ub} supports a configuration variable named @{b}NNTPRNEWS@{ub}. When
  624. defined, @{b}NNTPxfer@{ub} will call that program, with each incoming news
  625. article on standard input, and allow it to file that article. This
  626. allows the input to be filed along with UUCP news, and vice versa.
  627.  
  628.  
  629. For example, to be used with the AmigaUUCP RNEWS, the definition
  630. would be:
  631.  
  632.  
  633.     SetEnv NNTPRNews uucp:c/rnews -p
  634.  
  635.  
  636. with the -p indicating that this is a "postnews" call. Note that for
  637. maximum speed and efficiency, RNEWS should be a resident program.
  638.  
  639.  
  640. If the BATCH parameter is set for @{b}NNTPXfer@{ub}, then the correct setting would be:
  641.  
  642.  
  643.     SetEnv NNTPRNews uucp:c/rnews
  644.  
  645.  
  646. since more than one article will be contained in the input to RNEWS.
  647. Using the BATCH mode is much more efficient for a large feed than
  648. otherwise.
  649.  
  650.  
  651. @EndNode
  652.  
  653. @Node nntpserver "Configuration - NNTPServer"
  654.  
  655.  
  656. Local Environment:    set nntpserver news.somedomain.com
  657.  
  658. Global Environment:    setenv nntpserver news.somedomain.com
  659.  
  660. Configuration File:    NNTPServer news.somedomain.com
  661.  
  662. Default:        none
  663.  
  664.  
  665. To transfer articles via NNTP (Network News Transfer Protocol) requires
  666. that they be obtained from another computer. That other computer is the
  667. @{b}NNTPServer@{ub}.
  668.  
  669.  
  670. Your network provider will have to tell you the correct value to set
  671. for the @{b}NNTPServer@{ub}.
  672.  
  673.  
  674. @EndNode
  675.  
  676. @Node nntpuserid "Configuration - NNTPUserid"
  677.  
  678.  
  679. Local Environment:    set nntpuserid mbs
  680.  
  681. Global Environment:    setenv nntpuserid mbs
  682.  
  683. Configuration File:    NNTPUserid mbs
  684.  
  685. Default:        none
  686.  
  687.  
  688. Most network providers will not allow anonymous or unauthorized access
  689. to their NNTP server. Using the @{b}NNTPUserid@{ub} and @{b}NNTPPassword@{ub} configuration
  690. variables allows you to identify yourself to the NNTP server, based on the
  691. "AUTHINFO USER" protocol.
  692.  
  693.  
  694. Your network provider will assign you a @{b}NNTPUserid@{ub} and an @{b}NNTPPassword@{ub}.
  695.  
  696.  
  697. @EndNode
  698.  
  699. @Node nntppassword "Configuration - NNTPPassword"
  700.  
  701.  
  702. Local Environment:    set nntppassword somepassword
  703.  
  704. Global Environment:    setenv nntppassword somepassword
  705.  
  706. Configuration File:    NNTPPassword somepassword
  707.  
  708. Default:        none
  709.  
  710.  
  711. Most network providers will not allow anonymous or unauthorized access
  712. to their NNTP server. Using the @{b}NNTPUserid@{ub} and @{b}NNTPPassword@{ub} configuration
  713. variables allows you to identify yourself to the NNTP server, based on the
  714. "AUTHINFO USER" protocol.
  715.  
  716.  
  717. Your network provider will assign you a @{b}NNTPUserid@{ub} and an @{b}NNTPPassword@{ub}.
  718.  
  719.  
  720. @EndNode
  721.  
  722. @Node smtppost "Configuration - SMTPPost"
  723.  
  724.  
  725. Local Environment:    set smtppost INet:c/smtppost
  726.  
  727. Global Environment:    setenv smtppost INet:c/smtppost
  728.  
  729. Configuration File:    SMTPPost INet:c/SMTPPost
  730.  
  731. Default:        SMTPpost
  732.  
  733.  
  734. Setting this allows you to identify where the @{b}SMTPPost@{ub} binary
  735. resides, if it is not in your default path.
  736.  
  737.  
  738. @EndNode
  739.  
  740. @Node smtpspooldir "Configuration - SMTPSpoolDir"
  741.  
  742.  
  743. Local Environment:    set smtpspooldir INet:MailSpool
  744.  
  745. Global Environment:    setenv smtpspooldir INet:MailSpool
  746.  
  747. Configuration File:    SMTPSpoolDir INet:MailSpool
  748.  
  749. Default I-Net 225:    INet:MailSpool
  750.  
  751. Default AmiTCP:     AmiTCP:MailSpool
  752.  
  753.  
  754. @{b}SMTPSpoolDir@{ub} is the directory where SMTP spool files are to be
  755. located. If @{b}SMTPpost@{ub} cannot locate a destination host, it places
  756. the articles in this directory, and retries sending the messages on
  757. a regular basis. It @{u}may not@{uu} be shared with the UUCP spool directory, as the
  758. batch files are of a different format.
  759.  
  760.  
  761. This directory must exist.
  762.  
  763.  
  764. @EndNode
  765.  
  766. @Node smtpmaildir "Configuration - SMTPMailDir"
  767.  
  768.  
  769. Local Environment:    set smtpmaildir INet:Mail
  770.  
  771. Global Environment:    setenv smtpmaildir INet:Mail
  772.  
  773. Configuration File:    SMTPMailDir INet:Mail
  774.  
  775. Default I-Net 225:    INet:Mail
  776.  
  777. Default AmiTCP:     AmiTCP:Mail
  778.  
  779. Default UUCP:        UUMail:
  780.  
  781.  
  782. The directory where local mail is to be stored. This directory must
  783. exist.
  784.  
  785.  
  786. This directory may be shared with UUCP mailboxes and folders.
  787.  
  788.  
  789. @EndNode
  790.  
  791. @Node smtpsmarterhost "Configuration - SMTPSmarterHost"
  792.  
  793.  
  794. Local Environment:    set smtpsmarterhost dummy
  795.  
  796. Global Environment:    setenv smtpsmarterhost dummy
  797.  
  798. Configuration File:    SMTPSmarterHost dummy
  799.  
  800. Default:        none
  801.  
  802.  
  803. @{b}SMTPSmarterHost@{ub} is a SMTP host where mail is sent if a destination
  804. host named in an address is not reachable. It is presumed to be an
  805. Internet host which has better routing information than does the host
  806. running this @{b}SMTPd@{ub}. If not specified, no smarterhost routing will
  807. be done.
  808.  
  809.  
  810. @EndNode
  811.  
  812. @Node smtprmail "Configuration - SMTPRMail"
  813.  
  814.  
  815. Local Environment:    set smtprmail uucp:c/sendmail -r
  816.  
  817. Global Environment:    setenv smtprmail uucp:c/sendmail -r
  818.  
  819. Configuration File:    SMTPRMail uucp:c/sendmail -r
  820.  
  821. Default:        SMTPPost -r
  822.  
  823.  
  824. @{b}SMTPRMail@{ub} defines the program that will deliver mail which was
  825. destined for this host. Typically, it is a copy of @{b}SMTPpost@{ub}, renamed
  826. to RSMTP or SMTPpost with the -r argument.
  827.  
  828.  
  829. @EndNode
  830.  
  831. @Node smtpdelay "Configuration - SMTPDelay"
  832.  
  833.  
  834. Local Environment:    set smtpdelay 30
  835.  
  836. Global Environment:    setenv smtpdelay 30
  837.  
  838. Configuration File:    SMTPDelay 30
  839.  
  840. Default:        120
  841.  
  842.  
  843. @{b}SMTPd@{ub} uses the @{b}SMTPDelay@{ub} environment variable to determine how long
  844. to wait between scans of @{b}SMTPSpoolDir@{ub}. The
  845. default value causes @{b}SMTPd@{ub} to wait two minutes between each scan of the
  846. spool directory. Note that @{b}SMTPd@{ub} will not try to ship a specific
  847. file more often than two times @{b}SMTPDelay@{ub}. That is, for the default,
  848. a file will not be attempted more often than once every four minutes.
  849.  
  850.  
  851. @EndNode
  852.  
  853. @Node smtproute "Configuration - SMTPRoute"
  854.  
  855.  
  856. Local Environment:    set smtproute mx,smtp
  857.  
  858. Global Environment:    setenv smtproute mx,smtp
  859.  
  860. Configuration File:    SMTPRoute mx,smtp
  861.  
  862. Default:        mx,smtp,smarterhost,uucp
  863.  
  864.  
  865. @{b}SMTPRoute@{ub} may have any of four values, comma or space separated.
  866. The values are:
  867.  
  868.  
  869.     MX
  870.  
  871.     SMTP
  872.  
  873.     SmarterHost
  874.  
  875.     UUCP
  876.  
  877.  
  878. These values control the way @{b}SMTPpost@{ub} attempts to deliver mail to
  879. remote hosts.
  880.  
  881.  
  882. MX indicates to use the MX record (from DNS) to deliver the mail
  883. to the destination host via the forwarding host specified in the
  884. MX record.
  885.  
  886.  
  887. SMTP indicates to attempt to deliver the mail directly to the
  888. remote host.
  889.  
  890.  
  891. SmarterHost indicates to deliver the mail to the host specified
  892. as the @{b}SMTPSmarterHost@{ub} configuration variable. If @{b}SMTPSmarterHost@{ub} is
  893. not specified, then this type of transfer will not occur, and
  894. a warning will be issued if Smarterhost is specified.
  895.  
  896.  
  897. UUCP indicates to deliver the mail using the mail program specified
  898. as the @{b}UUCPSendMail@{ub} configuration variable. If @{b}UUCPSendMail@{ub} is not
  899. specified, then this type of transfer will not occur, and a warning
  900. will be issued if UUCP is specified.
  901.  
  902.  
  903. Note: the freeware version of @{b}SMTPpost@{ub} in INetUtils 1.4 only utilized the first
  904. MX record for any destination host.
  905.  
  906.  
  907. @EndNode
  908.  
  909. @Node smtpalwaysqueue "Configuration - SMTPAlwaysQueue"
  910.  
  911.  
  912. Local Environment:    set smtpalwaysqueue y
  913.  
  914. Global Environment:    setenv smtpalwaysqueue y
  915.  
  916. Configuration File:    SMTPAlwaysQueue yes
  917.  
  918. Default:        no
  919.  
  920.  
  921. When set to "yes", then @{b}SMTPpost@{ub} will act as if -Q was passed.
  922. The default is "no".
  923.  
  924.  
  925. When set, @{b}SMTPpost@{ub} will not attempt to deliver mail directly,
  926. but will allow @{b}SMTPd@{ub} to process the mail as part of it's regular
  927. cycle.
  928.  
  929.  
  930. This has the advantage of crash protection -- if a mail message does
  931. not go through @{b}SMTPd@{ub}, then it may reside only in memory. If the computer
  932. crashes for any reason while @{b}SMTPPost@{ub} is processing a message, then it
  933. is "lost". If it is queued on disk, then it will still exist, and will
  934. be reprocessed later.
  935.  
  936.  
  937. @EndNode
  938.  
  939. @Node hostaliases "Configuration - HostAliases"
  940.  
  941.  
  942. Local Environment:    set hostaliases othercomputer.com
  943.  
  944. Global Environment:    setenv hostaliases othercomputer.com
  945.  
  946. Configuration File:    HostAliases othercomputer.com
  947.  
  948. Default:        none
  949.  
  950.  
  951. The @{b}HostAliases@{ub} variable contains other hostnames which are the
  952. local host. For example, if your host is "x.y.z", but you also
  953. need to accept mail to "zz.zz" as local to you, you should set
  954. that in @{b}HostAliases@{ub}.
  955.  
  956.  
  957. In general, put "localhost,[ip.address],ip.address" plus any
  958. others into @{b}HostAliases@{ub}.
  959.  
  960.  
  961. The comparison is *not* case sensitive.
  962.  
  963.  
  964. Note: The freeware version of @{b}SMTPpost@{ub} in INetUtils 1.4 only allowed two
  965. entries in @{b}Hostaliases@{ub}.
  966.  
  967.  
  968. @EndNode
  969.  
  970. @Node smartfrom "Configuration - SmartFrom"
  971.  
  972.  
  973. Local Environment:    set smartfrom y
  974.  
  975. Global Environment:    setenv smartfrom y
  976.  
  977. Configuration File:    SmartFrom yes
  978.  
  979. Default:        no
  980.  
  981.  
  982. The very first line of a mail message is the envelope. This
  983. option controls the format of the envelope. Normally, it
  984. looks like this (with "SmartFrom no"):
  985.  
  986.  
  987.     From mbs Sat Jul 1 1995 17:42:12 (EST) remote from mycomputer.com
  988.  
  989.  
  990. and with "SmartFrom yes", it looks like this:
  991.  
  992.  
  993.     From mbs@mycomputer.com Sat Jul 1 1995 17:42:12 (EST)
  994.  
  995.  
  996. which is relevant to some mail readers (but very few).
  997.  
  998.  
  999. Note that this is @{u}not@{uu} the same thing as the "From:" header.
  1000.  
  1001.  
  1002. "SmartUUCP" is a deprecated synonym for @{b}SmartFrom@{ub}.
  1003.  
  1004.  
  1005. @EndNode
  1006.  
  1007. @Node checkuser "Configuration - CheckUser"
  1008.  
  1009.  
  1010. Local Environment:    set checkuser INet:c/checkuser
  1011.  
  1012. Global Environment:    setenv checkuser INet:c/checkuser
  1013.  
  1014. Configuration File:    CheckUser INet:c/CheckUser
  1015.  
  1016. Default:        none
  1017.  
  1018.  
  1019. The @{b}CheckUser@{ub} variable defines a program which is executed for
  1020. each piece of incoming mail to validate whether the destination user actually
  1021. exists. To wit:
  1022.  
  1023.  
  1024.         CheckUser userid
  1025.  
  1026.  
  1027. @{b}SMTPpost@{ub} checks the first character of standard output from the
  1028. program (stdout). If it is a '*', then the user is deemed invalid.
  1029. Any other output is defined as the fully-specified filename to
  1030. be used as the mailbox for the destination user.
  1031.  
  1032.  
  1033. Note: this feature is not available in the freeware version of
  1034. @{b}SMTPpost@{ub} in INetUtils 1.4.
  1035.  
  1036.  
  1037. @EndNode
  1038.  
  1039. @Node timezone "Configuration - TimeZone"
  1040.  
  1041.  
  1042. Local Environment:    set timezone (+0400)
  1043.  
  1044. Global Environment:    setenv timezone (+0400)
  1045.  
  1046. Configuration File:    TimeZone (+0400)
  1047.  
  1048. Default:        none
  1049.  
  1050.  
  1051. When required to generate a Date: header, @{b}SMTPpost@{ub} and @{b}NNTPpost@{ub} will generate
  1052. an ARPA date-time stamp as specified in RFC-822 (and modified by
  1053. RFC-1123). This is the format:
  1054.  
  1055.  
  1056.     Wed, 13 Oct 1993 18:52:04 EST
  1057.  
  1058.  
  1059. The @{b}TimeZone@{ub} variable would contain, for example, the "EST" as
  1060. shown above.
  1061.  
  1062.  
  1063. There are relatively few "legal" timezones specified in the
  1064. RFC. Some mail systems, and similarly some news systems, will
  1065. reject a Date which does not have a legal @{b}TimeZone@{ub}. To ensure
  1066. this "legality" a @{b}TimeZone@{ub} of the form:
  1067.  
  1068.  
  1069.     (+0500)
  1070.  
  1071.  
  1072. is preferred, @{u}with@{uu} the literal parentheses. The resulting
  1073. header would be:
  1074.  
  1075.  
  1076.     Wed, 13 Oct 1993 18:52:04 (+0500)
  1077.  
  1078.  
  1079. @EndNode
  1080.  
  1081. @Node uucpsendmail "Configuration - UUCPSendMail"
  1082.  
  1083.  
  1084. Local Environment:    set uucpsendmail uucp:c/rmail
  1085.  
  1086. Global Environment:    setenv uucpsendmail uucp:c/rmail
  1087.  
  1088. Configuration File:    UUCPSendMail uucp:c/rmail
  1089.  
  1090. Default:        none
  1091.  
  1092.  
  1093. If the @{b}SMTPRoute@{ub} variable includes UUCP as a part of it, then this
  1094. variable must be defined. It defines the program name of the UUCP
  1095. mail program (typically @{b}UUCP:C/RMail@{ub}).
  1096.  
  1097.  
  1098. @EndNode
  1099.  
  1100. @Node mailreadycmd "Configuration - MailReadyCMD"
  1101.  
  1102.  
  1103. Local Environment:    set mailreadycmd
  1104.  
  1105. Global Environment:    setenv mailreadycmd
  1106.  
  1107. Configuration File:    MailReadyCMD
  1108.  
  1109. Default:        none
  1110.  
  1111.  
  1112. @{b}SMTPpost@{ub} will attempt to run a command named by the
  1113. @{b}MailReadyCMD@{ub} configuration variable when delivering @{u}local@{uu} mail. The format
  1114. of the command is:
  1115.  
  1116.  
  1117.     MAILREADYCMD -x T:MailRdy
  1118.  
  1119.  
  1120. @{b}SMTPpost@{ub} will also cause the signal of a public message port named
  1121. "T:MailRdy" if it can be found.
  1122.  
  1123.  
  1124. @EndNode
  1125.  
  1126. @Node otherstuff "Configuration - Other Variables"
  1127.  
  1128.  
  1129. Other programs also use configuration information in the way described in this
  1130. document. Here are some common items used.
  1131. @{lindent 5}
  1132.  
  1133.  
  1134. ReplyTo
  1135. @{lindent 10}
  1136.  
  1137.  
  1138. Defines the address that an email reply to an email message or news article
  1139. should be sent to. For example:
  1140.  
  1141.  
  1142.     set ReplyTo mbs@somedomain.com
  1143. @{lindent 5}
  1144.  
  1145.  
  1146. WWW_Home
  1147. @{lindent 10}
  1148.  
  1149.  
  1150. The "Home Page" that should be accessed when a user clicks on the "Home" button
  1151. in a Web browser.
  1152. @{lindent 5}
  1153.  
  1154.  
  1155. HTTP_Proxy
  1156. @{lindent 10}
  1157.  
  1158.  
  1159. In order to get through a firewall, many users have to redirect World Wide Web
  1160. requests. This one allows a HTTP request to be redirected.
  1161. @{lindent 5}
  1162.  
  1163.  
  1164. FTP_Proxy
  1165. @{lindent 10}
  1166.  
  1167.  
  1168. In order to get through a firewall, many users have to redirect World Wide Web
  1169. requests. This one allows a FTP request to be redirected.
  1170. @{lindent 5}
  1171.  
  1172.  
  1173. GOPHER_Proxy
  1174. @{lindent 10}
  1175.  
  1176.  
  1177. In order to get through a firewall, many users have to redirect World Wide Web
  1178. requests. This one allows a Gopher request to be redirected.
  1179. @{lindent 5}
  1180.  
  1181.  
  1182. PopHost
  1183. @{lindent 10}
  1184.  
  1185.  
  1186. Some POP-mail clients use PopHost to the define the computer to access
  1187. to get POP mail.
  1188. @{lindent 5}
  1189.  
  1190.  
  1191. PopUser
  1192. @{lindent 10}
  1193.  
  1194.  
  1195. Some POP-mail clients use PopUser as the authorization name sent
  1196. to the POP host.
  1197. @{lindent 5}
  1198.  
  1199.  
  1200. PopPassword
  1201. @{lindent 10}
  1202.  
  1203.  
  1204. Some POP-mail clients use PopPassword as the password for "PopUser".
  1205.  
  1206.  
  1207. @EndNode
  1208.  
  1209.